home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / contrib / supported / xypic / readme < prev    next >
Text File  |  1995-03-15  |  3KB  |  94 lines
  1. -*-text-*- $Id: README.ctan,v 2.12 1994/10/28 21:39:53 kris Exp $
  2.  
  3.     ======================================================
  4.     THE Xy-pic PACKAGE FOR TYPESETTING GRAPHS AND DIAGRAMS
  5.     ======================================================
  6.  
  7. Xy-pic is a package for typesetting graphs and diagrams with TeX/LaTeX.
  8.  
  9. Xy-pic works with most formats, including LaTeX, AMS-LaTeX, AMS-TeX, and
  10. plain TeX, and has been used to typeset very complicated diagrams from
  11. many application areas including category theory, automata theory,
  12. algebra, and databases.
  13.  
  14. Xy-pic is structured as several orthogonal modules, each defining a
  15. custom notation for a particular kind of graphical object or structure.
  16.  
  17. These (combinable) structures are available:
  18.  
  19. * A graph combinator mode where diagrams are specified the way they are
  20.   composed as graphs.
  21.  
  22. * A matrix-like mode where the dimensions of the drawing are computed by
  23.   aligning diagram entries in rows and columns (this is also the
  24.   `version 2 compatibility mode').
  25.  
  26. * A polygon mode where diagrams shaped as regular polygons are entered
  27.   in a simple way.
  28.  
  29. * A general `turtle graphic' drawing language for specifying graphs with
  30.   objects and connections between them in a manner independent of
  31.   orientation.
  32.  
  33. The following objects may be used:
  34.  
  35. + Positions can be given in variety of formats (extendable) including
  36.   user defined coordinates (x,y) and relative to previous positions,
  37.   objects, object edges, and points on connections.
  38.  
  39. + Objects may be circular or rectangular (more shapes can be added) and
  40.   adjusted in several ways.
  41.  
  42. + Large library of objects with mnemonic names.
  43.  
  44. + Objects that orient themself along a connection when placed relative
  45.   to it, e.g., `\dir{|-}' is like \vdash but thus oriented; new such
  46.   objects can be defined in a convenient way.
  47.  
  48. + Includes circle segments and arbitrary TeX text.
  49.  
  50. + Connections are aligned between the reference points of objects but
  51.   start and end on the edges.
  52.  
  53. + Any object can be used to build a connection (using `diagonal
  54.   filling'); library objects provide common line types.
  55.  
  56. + Flexible notation for drawing arrows and general paths with tail,
  57.   stem, and head build from any object(s).  Special support for arrows
  58.   that cross each other, arrows that `go by' other entries, paired
  59.   arrows (including support for 2-cells), curved arrows, and arrows with
  60.   n/8 bends.
  61.  
  62. + Library of frames and braces.
  63.  
  64. + Special notation for rotation, scaling, colour, and line thickness.
  65.   The correct typesetting of these features requires a backend that
  66.   supports it (i.e., PostScript) but even when this is not available
  67.   Xy-pic tries to approximate what is requested such that at least the
  68.   picture size is stable (and thus page breaks).
  69.  
  70. + Output can use PostScript for drawing (several \special formats are
  71.   supported: dvips, dvitops, Textures, and OzTeX -- more are being added
  72.   continuously: contact Ross Moore <ross@mpce.mq.edu.au> for the current
  73.   list).  Notation for inclusion of literal PostScript is available.
  74.  
  75. All object forms may be used with all structures.
  76.  
  77.                  - o -
  78.  
  79. See CATALOG for up to date version information!
  80.  
  81. See TRAILER for author and accessibility information!
  82.  
  83. See MANIFEST for a complete file list!
  84.  
  85. See the various INSTALL files for how to install Xy-pic on your system!
  86.  
  87. See the W3 <URL: http://www.diku.dk/users/kris/Xy-pic.html> for news!
  88.  
  89. And finally, enjoy Xy-pic!
  90.  
  91. Sincerely,
  92.         Kristoffer H. Rose    <kris@diku.dk>
  93.         Ross Moore        <ross@mpce.mq.edu.au>
  94.